home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr25 / gnupltpm.zip / README < prev    next >
Text File  |  1993-03-08  |  6KB  |  153 lines
  1. Gnuplot 3.2 for OS/2 v 2.0
  2. ==========================
  3.  
  4. 1) Introduction
  5. ===============
  6.  
  7. This archive contains a version of Gnuplot 3.2 compiled for use on OS/2 2.0.
  8.  
  9. The command line interface of Gnuplot is retained, while graphics output is 
  10. plotted in a Presentation Manager Window. The Gnuplot command line
  11. appears in another text-mode window on the screen.
  12.  
  13. The PM window has facilities for printing the plot on the default printer,
  14. for changing the fonts used on the plot, and for switching between different 
  15. ways of plotting the lines (with colour, as dot/dashed lines, or both).
  16.  
  17. The command line window offers the usual Gnuplot interface. Both Unix-style 
  18. and DOS-style editing keys are supported.
  19.  
  20. The Gnuplot program was compiled with the emx/gcc compiler. It supports
  21. the shell command (type 'exit' to return to Gnuplot), can pipe datafiles
  22. through external commands using '<', and supports command-line substitution. 
  23. It runs the full set of demonstration programs supplied in the Gnuplot 
  24. source code distribution without problems. 
  25.  
  26.  
  27. 2) Files in this archive
  28. ========================
  29.  
  30. Copyrigh                -- Gnuplot copyright
  31. gnushell.exe            -- PM shell for gnuplot
  32. gs32beta.exe            -- Beta version of 32-bit gnushell (see below)
  33. gnushell.hlp            -- help file for above
  34. gnuplot.exe             -- Gnuplot 3.2
  35. gnuplot.gih             -- Gnuplot help file
  36. gnuplot.ini             -- example gnuplot initialisation file
  37. emx.dll                 -- dll used by Gnuplot
  38. README                  -- this file
  39. INSTALL                 -- installation instructions 
  40. docs/gnuplot.tex        -- Gnuplot manual in LaTeX format
  41. docs/titlepag.tex       -- part of above
  42. docs/toc_entr.sty       -- part of above
  43. source.zoo              -- source code for Gnushell 
  44.  
  45. 3) Running Gnuplot
  46. ==================
  47.  
  48. Gnuplot is run by running the PM program Gnushell.
  49. It is suggested that Gnushell is set up as a program object (see INSTALL).
  50.  
  51. Gnushell supplies the PM display part of Gnuplot. 
  52. It starts up a display window, and then starts up Gnuplot in a separate
  53. windowed command-line session.
  54.  
  55. Gnuplot appears as a separate text-mode window on the screen. The command
  56. line in this window can be treated like the Gnuplot command line on any 
  57. other system. Plots are displayed in the Gnushell window.
  58.  
  59. The Gnushell window has facilities for printing the plot, for changing
  60. the fonts used in the plot, and so on. These of course are handled
  61. through the usual PM interface.
  62.  
  63. The usual Gnuplot commands can also be used to produce output on
  64. supported devices.
  65.  
  66. Gnuplot itself communicates with Gnushell through a named pipe. 
  67. Plotting commands are sent to Gnushell which produces the plot when all 
  68. commands have been received. 
  69.  
  70. 4) The port of Gnuplot to OS/2
  71. ==============================
  72.  
  73. Changes to the code have been kept minimal. Besides the obvious addition
  74. of the PM driver code, the following are the major changes:
  75.  
  76. 1) Addition of code in readline.c to map keypad keys to editing functions,
  77.    to duplicate the MS-DOS mode of editing the command line. (See Gnuplot manual,
  78.    page 2.)
  79. 2) A workaround in graphics.c and graph3d.c for a compiler bug affecting
  80.    the C ?:; ifthenelse operator. This bug causes an internal compiler error
  81.    in both versions of the GNU gcc21 compiler.
  82.  
  83. The rest of the changes are associated with defining the use of the OS2 
  84. conditional value, and setting system-dependent stuff like names, signal
  85. handling, and end-of-line handling (LF vs CR+LF). 
  86.  
  87. See the file patches.os2 in the sources.zoo archive  
  88.  
  89. 5) Gnushell and Gs32beta
  90. ========================
  91.  
  92. Gnushell is a multithreaded PM program, and the version gnushell.exe
  93. was created using the 16-bit Microsoft 5.1 C compiler, with multithreaded
  94. libraries.
  95. Gs32beta.exe is a beta version of the 32-bit gnushell. It was created using the
  96. gcc21 compiler with single-threaded libraries. I have protected various
  97. regions of the code against clashes, but there may still be some. Please
  98. try it out, and report problems to me.
  99.  
  100. 6) Buglets 
  101. ==========
  102.  
  103. 6.1 The program can be terminated either from Gnushell or from Gnuplot.
  104.     In the latter case, the Gnushell window will not be closed if there
  105.     has been no graphics output (basically because Gnuplot has not yet
  106.     initialised the graphics driver).
  107.  
  108. 6.2 The Gnuplot window is opened with the root directory as the current
  109.     directory. It is suggested that a 'change directory' command be placed
  110.     in the gnuplot.ini file to start Gnuplot in a particular directory.
  111.     (There seems to be no way in OS/2 1.x to start a session with a 
  112.     non-root working directory (at least that I can find). There may
  113.     well be a way under OS/2 2.0, but Gnushell is still 16-bit, as I don't
  114.     have a compiler yet that supports multiple threads.)
  115.  
  116. 6.3 If you pipe a datafile through a shell command (manual, page 8, using <)
  117.     the screen switches momentarily to the session in which the spawned
  118.     command processor is running. (This is tied to the behaviour of system())
  119.  
  120. 7) Things to do
  121. ===============
  122.  
  123. 1) It would be nice to get the drawing going as the commands are coming in so 
  124.    there isn't a delay before things come up on the window. This is just
  125.    a question of appropriate synchronisation and enough semaphores, etc.
  126. 2) ... suggestions (?)
  127.  
  128. 8) Copyrights
  129. =============
  130.  
  131. The Gnuplot copyright is included; please see the file Copyrigh.
  132. ---
  133. emx.dll is Copyright (c) 1990-1992 by Eberhard Mattes.
  134. ---
  135. Gnushell is:
  136.     Copyright (c) 1992 by R. W. Fearick
  137.     All rights reserved
  138.      
  139.     THIS SOFTWARE IS PROVIDED AS IS AND WITHOUT WARRANTIES OF ANY KIND. 
  140.    
  141.     Permission is hereby granted for personal, non-commercial use of this 
  142.     software.You are granted the right to use, modify, and redistribute 
  143.     it for for non-commercial purposes, provided that all copyright 
  144.     notices remain intact and all changes are clearly documented.      
  145.     THE AUTHOR MAKES NO WARRANTY OF ANY KIND WITH RESPECT TO THIS PRODUCT 
  146.     AND EXPLICITLY DISCLAIMS ANY IMPLIED WARRANTIES OF MERCHANTABILITY 
  147.     OR FITNESS FOR ANY PARTICULAR PURPOSE.                               
  148.  
  149.  
  150. Roger Fearick
  151. fearick@physci.uct.ac.za
  152. 25 July, 1992 
  153.